home *** CD-ROM | disk | FTP | other *** search
/ Zoom 2 / Zoom - Release 2 (1996)(Active Software)[!].iso / programming / amos / ercole / readme < prev   
Encoding:
Text File  |  1996-03-25  |  5.0 KB  |  153 lines

  1. Short:    AMOS Extension V1.6. Gives 10 new commands to AMOS Basic
  2. Uploader: ercole@maltanet.omnes.net (Ercole Spiteri)
  3. Author:   ercole@maltanet.omnes.net (Ercole Spiteri)
  4. Type:     dev/amos
  5.  
  6. Ercole.Lib AMOS Extension V1.6
  7. ------------------------------
  8.  
  9. Introduction
  10. ~~~~~~~~~~~~
  11. This is an AMOS extension which provides 10 new commands to AMOS basic and Compiler.
  12. The commands provide the possibility for game programmers to utilise the game ports
  13. of the Amiga to their best, thus making the creation of multiplayer games with AMOS
  14. easier. There are commands for the 3rd and 4th Joysticks using the parallel 4 port
  15. player addaptor, commands for the 2nd and 3rd buttons available on games consoles
  16. joysticks and finally there is also support for paddles or analog joysticks. Also
  17. included are commands which give access to Cli and external libraries.
  18.  
  19. FreeWare
  20. ~~~~~~~~
  21. This program is freeware, ie, you can copy it and distribute it as much as you like
  22. provided the archive is kept intact. If you use the program a lot then please send
  23. me an E-Mail to let me know that you found the program usefull.
  24.  
  25. New Commands
  26. ~~~~~~~~~~~~
  27. This extension adds the following commands to AMOS:
  28.  
  29. System Commands:
  30. ---------------
  31.  
  32. Cli <string>,<integer>,<string>                  Function: Calls Cli cammands from AMOS
  33.        A         B         C
  34.  
  35. where; A=Cli command line eg List DF0:
  36.        B=Input File handle if needed else place a 0
  37.        C=Filename where Output of command will be redirected to.
  38.  
  39.  
  40.  
  41. <integer>=Library Open (<string>)                Function: Opens any Amiga Library
  42.     A                      B
  43.  
  44. where; A=Integer where address of library opened will be placed. Functions of the library
  45.          can be called by using the Call command eg Call A-30 (for first function).
  46.        B=Library name eg dos.library
  47.  
  48.  
  49.  
  50. Library Close <integer>                          Function: Closes opened Libraries
  51.                   A
  52.  
  53. where; A=result of Library Open function
  54.  
  55.  
  56. Gameports Commands:
  57. ------------------
  58.  
  59. The following 2 commands allow access to joysticks 3 and 4. These can be attached to an
  60. Amiga using the parallel port 4 player adapter lead.
  61.  
  62. <integer>=Ext Joy(<integer>)                     Funtion: Check direction of joystick
  63.     A                 B
  64.  
  65. where; A=Number given reflects direction of joystick
  66.        B=0 for 3rd joystick and 1 for 4th joystick
  67.  
  68.  
  69.  
  70. <integer>=Ext Fire(<integer>)                    Function: Check if fire button pressed
  71.     A                  B
  72.  
  73. where; A=-1 if button pressed else 0
  74.        B=0 for 3rd joystick and 1 for 4th joystick
  75.  
  76.  
  77. The following 2 commands allow access to the 2nd and 3rd fire bottons of Joysticks 1 and 2
  78. if available.
  79.  
  80. <integer>=Xfire(<integer>)                       Function: Check if 2nd button is pressed
  81.     A               B
  82.  
  83. where; A=-1 if button pressed else 0
  84.        B=0 for 1st joystick and 1 for 2nd joystick
  85.  
  86.  
  87. <integer>=Yfire(<integer>)                       Function: Check if 3rd button is pressed
  88.     A               B
  89.  
  90. where; A=-1 if button pressed else 0
  91.        B=0 for 1st joystick and 1 for 2nd joystick
  92.  
  93.  
  94. The following 4 commands deal with paddles attached to ports 1 and 2. They can also be
  95. used to read analog joysticks.
  96.  
  97. Prop On                                          Function: Starts Paddles testing
  98.  
  99.  
  100.  
  101. Prop Off                                         Function: Stops Paddles testing
  102.  
  103.  
  104.  
  105. <integer>=Paddle(<integer>)                      Function: Read Paddle potentiometer
  106.     A                B
  107.  
  108. where; A=Potentiometer reading (1-255)
  109.        B=Paddle number (0-3)
  110.  
  111.  
  112.  
  113. <integer>=Pad Fire(<integer>)                    Function: Check Fire Buttons of Paddles
  114.     A                  B
  115.  
  116. where; A=-1 if button pressed else 0
  117.        B=Paddle number (0-3)
  118.  
  119. Known bugs:
  120. ----------
  121.  
  122. Due to a bug in Amos, paddles 0 and 1 and an analog joystick in port 0 will not work. This is
  123. since port 0 is the mouse port and AMOS basic continually writes to the registers of port 0 to
  124. be able to read the mouse right and middle buttons.This affects the potentiometer readings of port 0 
  125. which would have worked perfectly where it not for this reason. If in the future AMOS would have a 
  126. command which stops the mouse right and middle buttons checking then this bug would be fixed. Thus I 
  127. did not disable checking of paddles and analog joysticks on port 0 in the hope that the writer of AMOS 
  128. will in the future provide a command which disables the checking of these mouse buttons.
  129.  
  130. Installation:
  131. ~~~~~~~~~~~~
  132. Place the Ercole.Lib file in your AMOS_System drawer and add this line in your Extension list:
  133.  
  134. AMOS_System/Ercole.Lib
  135.  
  136. Place this extension as extension 10 otherwise it won`t work, if you have another extension which
  137. needs extension 10 to work then tell me and I will make a special version for your system.
  138.  
  139. Contacts:
  140. ~~~~~~~~
  141. You can contact the Author of this extension by:
  142.  
  143.  Snail Mail: Ercole Spiteri
  144.              `Villa Loreto`, Bishop Buttigieg Street,
  145.              Qala,
  146.              Gozo, Malta, Europe.
  147.              GSM 103
  148.  
  149.  E-Mail: ercole@maltanet.omnes.net
  150.  Voice Phone: +(356) 554929
  151.  BBS Phone: +(356) 564184
  152.  
  153.